package com.tianji.promotion.service;

import com.tianji.common.domain.dto.PageDTO;
import com.tianji.promotion.domain.dto.CouponFormDTO;
import com.tianji.promotion.domain.dto.CouponIssueFormDTO;
import com.tianji.promotion.domain.po.Coupon;
import com.baomidou.mybatisplus.extension.service.IService;
import com.tianji.promotion.domain.query.CouponQuery;
import com.tianji.promotion.domain.vo.CouponDetailVO;
import com.tianji.promotion.domain.vo.CouponPageVO;
import com.tianji.promotion.domain.vo.CouponVO;

import java.util.List;

/**
 * <p>
 * 优惠券的规则信息 服务类
 * </p>
 *
 * @author xzh
 * @since 2024-03-20
 */
public interface ICouponService extends IService<Coupon> {

    /**
     * 新增优惠券
     * @param couponFormDTO
     */
    void saveCoupon(CouponFormDTO couponFormDTO);

    /**
     * 优惠券分页查询
     * @param query
     * @return
     */
    PageDTO<CouponPageVO> queryCouponPage(CouponQuery query);

    /**
     * 发放待发放和暂停中状态的优惠券
     * @param id
     * @param formDTO
     */
    void issueCouponByStatus(Long id, CouponIssueFormDTO formDTO);

    /**
     * 编辑优惠券信息
     * @param couponFormDTO
     */
    void updateCouponById(CouponFormDTO couponFormDTO);

    /**
     * 删除优惠券
     * @param id
     */
    boolean deleteCouponAndScope(Long id);

    /**
     * 根据id查询优惠券详细信息
     * @param id
     * @return
     */
    CouponDetailVO getCouponDetail(Long id);

    /**
     * 将发放中的优惠券改为暂停发放
     * @param id
     */
    void stopIssueCouponAndExchangeCodeById(Long id);

    /**
     * 定时扫秒将未开始状态以及开始时间已到或已过的优惠券状态设置成发放中 同时发送其对应的code
     */
    void taskIssuesCouponAndCode();

    /**
     * 定时将发送时间已过的优惠券状态设为已结束 包括对应兑换码
     */
    void taskStopIssuesCouponAndCode();

    /**
     * 向用户展示优惠券详情
     * @return
     */
    List<CouponVO> queryIssuingCoupons();
}
